home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / catD / esbbcall.z / esbbcall
Encoding:
Text File  |  1998-10-30  |  5.0 KB  |  132 lines
  1.  
  2.  
  3.  
  4. eeeessssbbbbbbbbccccaaaallllllll((((DDDD3333))))                                                      eeeessssbbbbbbbbccccaaaallllllll((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _eeee_ssss_bbbb_bbbb_cccc_aaaa_llll_llll - call a function when an externally-supplied buffer can be
  10.      allocated
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_tttt_yyyy_pppp_eeee_ssss_...._hhhh_>>>>
  14.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_ssss_tttt_rrrr_eeee_aaaa_mmmm_...._hhhh_>>>>
  15.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  16.      _tttt_oooo_iiii_dddd______tttt _eeee_ssss_bbbb_bbbb_cccc_aaaa_llll_llll_((((_iiii_nnnn_tttt _p_r_i_,,,, _vvvv_oooo_iiii_dddd _((((_****_f_u_n_c_))))_((((_))))_,,,, _llll_oooo_nnnn_gggg _a_r_g_))))_;;;;
  17.  
  18.    AAAArrrrgggguuuummmmeeeennnnttttssss
  19.      _p_r_i       Priority of the _eeee_ssss_bbbb_aaaa_llll_llll_oooo_cccc(D3) allocation request.
  20.  
  21.      _f_u_n_c      Function to be called when a buffer becomes available.
  22.  
  23.      _a_r_g       Argument to the function to be called when a buffer becomes
  24.                available.
  25.  
  26. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.      If _eeee_ssss_bbbb_aaaa_llll_llll_oooo_cccc(D3) is unable to allocate a message block header and a data
  28.      block header to go with its externally supplied data buffer, the function
  29.      _eeee_ssss_bbbb_bbbb_cccc_aaaa_llll_llll can be used to schedule the routine _f_u_n_c, to be called with the
  30.      argument _a_r_g when memory becomes available.  _eeee_ssss_bbbb_bbbb_cccc_aaaa_llll_llll, like _bbbb_uuuu_ffff_cccc_aaaa_llll_llll(D3),
  31.      serves, in effect, as a timeout call of indeterminate length.
  32.  
  33.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  34.      On success, _eeee_ssss_bbbb_bbbb_cccc_aaaa_llll_llll returns a non-zero value that identifies the
  35.      scheduling request.  On failure, _eeee_ssss_bbbb_bbbb_cccc_aaaa_llll_llll returns 0.
  36.  
  37. UUUUSSSSAAAAGGGGEEEE
  38.      When _f_u_n_c runs, all interrupts from STREAMS devices will be blocked.  On
  39.      multiprocessor systems, the interrupts will be blocked only on the
  40.      processor on which _f_u_n_c is running.  _f_u_n_c will have no user context and
  41.      may not call any function that sleeps.
  42.  
  43.      Even when _f_u_n_c is called, _eeee_ssss_bbbb_aaaa_llll_llll_oooo_cccc can still fail if another module or
  44.      driver had allocated the memory before _f_u_n_c was able to call _aaaa_llll_llll_oooo_cccc_bbbb.
  45.  
  46.      The _p_r_i argument is no longer used, but is retained for compatibility.
  47.  
  48.      The non-zero identifier returned by _eeee_ssss_bbbb_aaaa_llll_llll_oooo_cccc may be passed to
  49.      _uuuu_nnnn_bbbb_uuuu_ffff_cccc_aaaa_llll_llll(D3) to cancel the request.
  50.  
  51.    LLLLeeeevvvveeeellll
  52.      Base or Interrupt.
  53.  
  54.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  55.      Does not sleep.
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. eeeessssbbbbbbbbccccaaaallllllll((((DDDD3333))))                                                      eeeessssbbbbbbbbccccaaaallllllll((((DDDD3333))))
  70.  
  71.  
  72.  
  73.      Driver-defined basic locks, read/write locks, and sleep locks may be held
  74.      across calls to this function.
  75.  
  76. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  77.      _aaaa_llll_llll_oooo_cccc_bbbb(D3), _bbbb_uuuu_ffff_cccc_aaaa_llll_llll(D3), _eeee_ssss_bbbb_aaaa_llll_llll_oooo_cccc(D3), _iiii_tttt_iiii_mmmm_eeee_oooo_uuuu_tttt(D3), _uuuu_nnnn_bbbb_uuuu_ffff_cccc_aaaa_llll_llll(D3)
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.                                                                         PPPPaaaaggggeeee 2222
  129.  
  130.  
  131.  
  132.